mouseEnter

Type

message

Summary

Sent when the mouse pointer moves into an object.

Syntax

mouseEnter

Description

Handle the mouseEnter message to perform an action (for example, display additional information or highlight a button) when the mouse pointer enters an object.

The mouseEnter message is sent only when the Browse tool is being used.

If two controls overlap, a mouseEnter message is sent whenever the mouse pointer crosses into a visible portion of a control. The control on the bottom receives a mouseEnter message only when the mouse pointer enters part of the control that can be seen. A control that is completely hidden by another control on top of it will never receive a mouseEnter message.

If the mouse button is down when the mouse pointer enters the control, the mouseEnter message is not sent unless the mouse button is released while the pointer is still in the control.

If a control is shown (by changing its visible property to true or using the show command), and the mouse pointer is over the control when it is shown, LiveCode sends a mouseEnter message to the control.

note

Take care when using both mouseEnter and mouseLeave in the same control that an unintentional infinite loop may be invoked. To prevent a loop, use a condition in the mouseLeave message handler to ensure the mouse pointer is still outside of the control or in the mouseEnter message to check the mouse pointer is still inside the control.

Examples

on mouseEnter -- show a Help field for the control the mouse is over
  show field (the short name of the target && "Help")
end mouseEnter

Related

object: button

command: show

function: mouseControl

glossary: property, highlight, Browse tool, message, mouse pointer, command, object, loop

keyword: control

message: dragEnter, mouseLeave

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile